Welcome to
Version1.00a
Copyright © GME Systems Pty Ltd
Perth, Western Australia
Last updated 1 March, 1996
Contents
- Introduction
- Installation
- How to get the most out of the program
- Ordering Information
Welcome To Swag-Man.
This file is intended to be a readme type file, with basic instructions on how to use the program.
Swag-Man is one of the few HTML editors that allow the user to preview their work as they go, this enables developers to adjust and tinker with their tag arrangements to achieve the results they are after.
The program starts up with a skeleton of a html file ready for the user to flesh out.
The program was designed so the the user can start typing their text directly into the BODY section of the skeleton, and when the bulk of the text is in, the formating would start.
To enclose any piece or block of text to a HTML tag, just highlight that section of text using the mouse and then press the desired button on the Left-Hand side of the editor or choose on one the less frequently used commands under the HTML heading on the main menu.
So for example :
To make a sentence bold, the user would select the text sentence using the mouse, and then press the B button on the left-hand side. The sentence would now start with <B>, and end with </B>.
Creating Headings is no different, just select the block of text, and then choose the appropriate option on the LH side of the screen.
List are different though. At the moment a skeleton of a list style is generated, and you have to fill in the blanks, I hope to have it working so that a block of text is selected, and that text is converted into a list, like in word processors. But that will come in a later version.
Back to table of contents
- Set the background colour of the Fly-By Help, so that it is comfortably readable. You do this in the options dialogue box (Options|Define Options).
- Enter your email address in the Options|Define Options dialogue box.
- Enter your browser's location in the Options|Define Options dialogue box.
- Press F9 to quickly preview your document.
- Press Ctrl+B to see how your document looks using your favoutite browser, but please remember to shut the browser down when finished with it, as Swag-Man will start another copy. I am working on fixing that .. :-)
- Select the font you are most happy with for the editor and Previewer using the Options menu facility.
- Set the automatic save feature working (Options|Define Options), as things can go wrong, because if the program crashed unexpectedly, any files currently open will be lost ..
- Cut an paste between multiple documents loaded. And switching from document to document using the Window menu facility.
- Easily retrieve the last document you worked on using the file history facility under the File menu.
- Gain access to a greater range of HTML commands than are avialble on the LH side of the screen using the HTML menu facility.
- You can store commonly used URL links in the links dialogue box. When choosing a previously defined URL from the drop-down list, and then deceide that you don't want it any more. Press the ESC key, and the drop down list disappears.
Back to table of contents
Text Formating
- Bold Text
- Italicized Text
- Underlined Text
- Emphasized Text
- Strong Text
Code Text
- Citation Text
- Keyboard Text
- Sample Text
- Teletype Text
- Variable Element Text
- Bold and Italicized Text
Back to table of contents
Tables
This is a table's caption
This |
is |
a |
Table |
generated |
using Swag-Man |
Back to table of contents
Headings
Heading 1
Heading 2
Heading 3
Heading 4
Heading 5
Heading 6
Back to table of contents
Lists
- No 1
- No 2
- No 3
- First Line
- Second Line
- No 1
- No 2
- No 3
- No 4
- Third Line
- Fourth Line
- No 4
- No 5
Back to table of contents
Templates
Swag-Man now supports templates.
Templates are commonly used styles that you have developed for a particular purpose. So for example :
You are currently designing a number of Web pages for a variety of corporate clients, and each client has a different basic style for their WWW pages. So when a customer contacts you again, and asked for additional pages, you can go back and select their template and be up to speed in no-time at all.
Commonly used "things" in templates are items such as :
- Company Logos
- Company Address Information.
- Links to other web pages, that relate to that company, etc
Swag-Man now allows you to create a HTML file and then save it as a template, so that you can access them every time you select File|New or press the New button on the top most speedbar.
You create a template by choosing File from the Main menu and then selecting Save as Template.
A dialogue box appears, if this is the first time you are using it, the box will show 3 blank-white rectangles. The rectangle on the Left-Hand side is a list of all available templates that you defined so far. The Top-most box is for you to enter a name for the template. This can be any string of charcters(up to 255 chars). It is not a file name but a short descriptive name, such as Template 1, XYZ Company. The box below it is for a more detailed description of the template. Again limited to 255 chars. So for example, if you have defined a template called XYZ Co, and then describe it as "This is a template for the XYZ Company, that holds a whole pile of external links for them ..."
The program is clever enough to realise that when you first start Swag-Man it checks to see if you have any templates defined. If not it automatically creates a blank HTML file structure for you, even if you have pressed File|New.
Back to table of contents
Creating Forms
Currently the Prevewing option of Swag-Man does not display forms. So please use your favourite browser to preview them.
To create a form, it is generally a good idea to have already thought out and implemented your CGI script you are going to attach to this form. This makes life a lot easier.
If you press the Forms button on the main toolbar, a multi-tadded dialogue box appears, showing all the major form items that are available in Swag-Man.Forms is also available from the main menu, where it is broken down into it logical components.
- Form Skeleton
- Single Line Text Fields
- Multiline Text Fields
- Checkboxes
- Radio Buttons
- Selection Lists
- Buttons
- , allows you to define the scripts that this form is attached to and builds a skeleton of a form ready for fleashing out ..
- , This option creates text input options for defing single line text input boxes.
Name is the variable to be associated with the data eneterd into the box.
The No of charcaters is the number of charcters to be collected
Maxium No of characters is the maximum no of charcters to be collected, any more than that and the data is truncated ..
TheText to be displayed is the caption associated with that text field.
So for example if you prompting a user to enter their email address, then:
- Name is "Users_Email_address"
- No Characters is 20
- Maximum No of characters is 100
- Text to be displayed, could be "Enter your email address :"
-
Multiline text is very similar to single line text fields, except that it requires the no of columns and no of rows in which to collect the data. Again the data is stored against the variable stored in Name ..
-
Radio buttons are relatively simple. They require a Name or group ID, a variable and some text to display. So for example :
Say you want to make a radio button for selecting animal types, you could construct them as follows :
<INPUT TYPE="radio" NAME="theAnimal" VALUE="Dog">A Dog
<INPUT TYPE="radio" NAME="theAnimal" VALUE="Cat">A Cat
In this example, the Group ID is "theAnimal", and the values are for "Dog" and "Cat"
-
Check boxes are almost exactly the same as radio buttons, except that they don't have a group ID, but do have a value specify that the box is checked by default or not..
An example :
<INPUT TYPE="checkbox" NAME="SendInfo" VALUE="checked">Select if you want information sent to you
-
Selections are basically pop-up list/Combo boxes, from which the user can select information whilst filling in form.
Again the structure is similar to that used above. The user enters a Name (eg : ShoppingItems), and then enters each item that they want see appear in the selection list.This is done by adding info into the "Selection value" text box, and then pressing "Add To List". If you want to delete an item from the selection list, choose it in the listbox on the right hand side of the dialogue box, and then press the "Delete Item" button.
An example of a pop-up selection list is as follows :
<SELECT NAME ="ShoppingList">
<OPTION>Soap
<OPTION>Tooth Brush
<OPTION>Shoes
<OPTION>Food
</SELECT>
-
There are basically only 2 types of buttons. Submit & Reset.
Creating either of these buttons is simplicity it self. Simply select the type of button you want and the text to be associated with it. So for example :
You want a "Submit Data" button on your form. The output code would look as follows :
<INPUT TYPE="submit" VALUE="Submit Data">
Back to table of contents
Background Attributes
Setting background attributes is relatively simple. Select HTML from the Main menu, and choose the background option.
A dialogue box appears showing 3 sets of colour sliders, for setting the background colour, text colour and Links(or hot spot colours). It images are to be used for the background, then there is a place for selecting the directed image file, and when the HTML file is viewed either with the previewer or with your browser, that image is tiled on the background of the file.
Experiment with different colour options, I realise that the colour shown in the sample boxes on the left-hand side of each slider set if not perfect, but I am working on getting it better. Just treat is as a guide to what you would like.
A coomonly used backgroubnd colour is light grey, this has RGB valued of 128,128,128
Back to table of contents
Remove TAGS from HTML files
A commonly requested add-on has been for the inclusion of a HTML tag removal option. This is now available under the Tools menu item on the main menu.
It allows the user to remove all tags within a whole file, or only a portion of a selected file. If only a selected portions of the text is required, the program then prompts the user if they wish to save the new text to a seperate file or to include it in the current file. If the complete file is selected(or nothing selected al all), the resultant file is thehn saved to another file, which is specified by the user.
The Remove Tag's dialogue box that appears has the following options :
- Convert all <P> &<BR> tags to line breaks. This attamepts to preserve some of the formatting of the file.
- Convert all & to &. This converts the code & to the & symbol.
- Convert all < tags to < symbols.
- Convert all > tags to > symbols.
Back to table of contents
The commercial version of Swag-Man, is planned for release on 1 March , 1996
The pricing structure is as follows:
- Option 1
A full operating version of the editor plus Previewing facilities, including all upgrades for 1 year and a Windows 95® version when available will.
Price :$75 (Australian dollars, approximately US$55)
- Option 2
A full operating version of the editor plus Previewing facilities
This does not included any upgrades or a Windows 95® version.
Price :$50 (Australian dollars, approximately US$38)
- Option 3
A full operating version of the editor minus Previewing facilities
This does not included any upgrades or a Windows 95® version
.
Price :$30 (Australian dollars, approximately US$22.50)
Payment at this stage is by cheque only(currently negotiating with the Banks to be able to accept credit cards), and please make it payable in Australian dollars to GME Systems Pty. Ltd., and please make sure an Australian bank will accept the cheque; and sent it to :
GME Sytems Pty. Ltd.
240 Woodside Street
DoubleView, Perth
Western Australia,
Australia, 6018
Also please send a snail mail address. I will use this when I cannot contact you via e-mail ..
Before sending any money, please check that you have the latest version and latest payment methods by dropping by at Swag-Man's home page at :
http://www.iinet.net.au/~bwh/swagman.html
A registration key will then be sent to you, and it unlocks the registered program hiding inside the evaluation version. This key will be sent to you as soon as the cheque clears.
Back to table of contents